home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Dr. Windows 3
/
dr win3.zip
/
dr win3
/
COMMUNIC
/
WDIAL110.ZIP
/
WDIAL.DOC
next >
Wrap
Text File
|
1993-08-16
|
7KB
|
197 lines
Wdial is an autodialer for modems with the hayes/AT-command set
operating under Microsoft Windows 3.0 or later.
Starting the program
-----------------------------------------------------------------------
To start the program use the following command line :
wdial <parameter file>
<parameter file> is a pathname to the file containing the dialing
parameters. The file name is used as is to open the file for reading.
If no filename is given, wdial defaults to the file PHONE.LST in the
directory of the executable. (See the section 'Parameter file format'
for details on the file format.)
You'll probably want to add wdial as a Program manager item. To do
this, use Program Manager's File/New-menu entry.
Exiting from the program
-----------------------------------------------------------------------
Use the Quit-button to exit wdial.
Using the program
-----------------------------------------------------------------------
Select the desired entries from the list box and then click the
OK-button to start. The OK-button now changes to Cancel-button
which can be used to cancel the dialing, after which a new set of
entries can be selected. The Clear-button can be used to clear all
selections.
When started wdial starts to go trough the selected entries
sequentially, starting again from the first, as the last one has
been processed. It stops when the local modem has connected to
a remote modem, when the user stops it by clicking the Cancel-
button, when no entries remain (see Notes section below) or when
an error occurs.
Parameter file format
-----------------------------------------------------------------------
The file consists of three line entries separated by blank line(s).
When reading the a line, trailing whitespace characters are ignored.
If the character '#' is encountered the rest of the line is ignored.
A line containing a '#' as its first non-whitespace character is
treated as an empty line.
Entry format :
<entry name>
<phone number / modem command>
<COM<port>:<bps>,<parity>,<databits>,<stopbits>>
<entry name> specifies the name by which you select the entries
when running wdial.
<phone number / modem command> specifies a phone number or a literal
modem command related to the entry.
The following escape sequences can be used :
\r : <cr>
\p : pause for 0.1 s before sending next character
\P : pause for 1 s before sending next character
<COM<n>:<bps>,<parity>,<databits>,<stopbits>> specifies the com-
port and line parameters used :
<n> : com-port number (1 - 4)
<bps> : communication speed (e.g. 1200,2400,4800,9600,19200)
<parity> : parity (N/E/O)
<databits> : databits (7/8)
<stopbits> : stopbits (1/2)
Sample parameter file
----------------------------------------------------------------------
#
# INITIALIZE : load defaults / enable result codes
# word result codes / wait 30 s for carrier
#
INITIALIZE
ATZ Q0 V1 S7=30
COM2:2400,N,8,1
#
# A hangup command entry must be
# provided for all used speeds.
#
HANGUP 2400
\P+++\P\PATH0
COM2:2400,N,8,1
HANGUP 1200
\P+++\P\PATH0
COM2:1200,N,8,1
# phone numbers
University modem bank
123456
COM2:2400,E,7,1
Max's BBS
654321
COM2:1200,N,8,1
Notes
----------------------------------------------------------------------
If the first character of a <phone number / modem command> entry
is not a digit, the string is sent to the modem with a CR added to
the end. If the first character is a digit, the modem command ATD
is added before the string and a CR is added to the end of it
before sending it to the modem.
After sending a dial or other command string, wdial waits for a
result code from the modem. Upon receiving a code, one of the
following actions is taken depending on the particular code :
OK, ERROR : proceed to next, skip this in the following rounds
CONNECT : stop dialing
other : proceed to next
If no result code is received within 60 seconds, a timeout occurs.
When comparing the result code string against CONNECT, wdial is
satisfied with a string beginning with CONNECT.
It is required for correct operation, that the modem responds to
commands with the word response codes. Therefore, when using
literal modem commands be careful not to affect the result codes.
Usually, the word result codes are used by default. If this is
not the case, you need to send the AT-commands Q0 V1 to the modem
before dialing. This is best done by creating a literal modem
command entry containing those commands. Such an entry should be
placed before the phone number entries, so that you can select it
along with the phone numbers required and it gets fed to the modem
before any dialing command. Because of the action upon the OK or
ERROR result code, such an initialization string is sent to the
modem only once and skipped in the following rounds.
If you want to explicitly specify a dial method, use the appropriate
dialing command in the phone number entry instead of plain phone
number (ATDP for pulse dialing, ATDT for tone dialing).
Note that all the dial modifiers in the AT command set can be used
in a plain phone number entry (as long as it begins with a digit).
If your modem doesn't detect when the line is busy and in that case
respond with the BUSY result code, you might want to modify the
modem's carrier wait time. Use the AT-command S7=NN to set the
timeout to NN seconds.
Bugs and caveats
----------------------------------------------------------------------
Wdial doesn't always respond immediately to a Cancel- or Quit-button
press. This is because it calls Yield() (instead of returning from
the message handler function) at some points such as while waiting
the delay specified by the \P escape sequence to complete, and hence
the processing of the messages generated by the buttons is delayed.
Wdial.exe 1.00 was by accident marked for Windows 3.1 or later,
though it should work from 3.0. This has been corrected with 1.01.
The former versions of this file had the parameter file examples
all wrong : the command/phone number and line parameter lines had
swapped places. This has now been corrected.
There have been quite substatintial changes in Wdial code from
version 1.01 and earlier. Hence, I think the minor version number
should increase all the way to 1.10 although the only impact actually
visible to the user is that Wdial now shows up in the Task List as
supposed.
----------------------------------------------------------------------
Copyright (C) 1992, 1993 Jouni Leppäjärvi. This version (1.10) of
wdial may be used and distributed freely. The program and the
documentation are provided 'as is' with no warranty of any kind.
I assume no responsibility for any damage or loss caused by this
software either directly or indirectly. Comments, suggestions and
bug reports are welcome. (jml@stekt.oulu.fi) -- Jouni Leppäjärvi
----------------------------------------------------------------------